{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "VegVdI5SakPo"
   },
   "source": [
    "# Generating Price Data using Stocastic Processes\n",
    "\n",
    "* Geometric Brownian Motion (GBM)\n",
    "* Fractional Brownian Motion (FBM)\n",
    "* Heston Stochastic Volatility Model\n",
    "* Cox Ingersoll Ross (CIR)\n",
    "* Ornstein Uhlebneck stochastic process\n",
    "\n",
    "\n",
    "## Model Parameters\n",
    "\n",
    "The model parameters class contains all of the parameters used by the following stochastic processes. The parameters have been prefixed with the name of the stochastic process they are used in. Calibration of the stochastic processes would involve looking for the parameter values which best fit some historical data.\n",
    "*   `all_s0` This is the starting asset value\n",
    "*   `all_time` This is the amount of time to simulate for\n",
    "*   `all_delta` This is the delta, the rate of time e.g. 1/252 = daily, 1/12 = monthly\n",
    "*   `all_sigma` This is the volatility of the stochastic processes\n",
    "*   `gbm_mu` This is the annual drift factor for geometric brownian motion\n",
    "*   `jumps_lamda` This is the probability of a jump happening at each point in time\n",
    "*   `jumps_sigma` This is the volatility of the jump size\n",
    "*   `jumps_mu` This is the average jump size\n",
    "*   `cir_a` This is the rate of mean reversion for Cox Ingersoll Ross\n",
    "*   `cir_mu` This is the long run average interest rate for Cox Ingersoll Ross\n",
    "*   `all_r0` This is the starting interest rate value\n",
    "*   `cir_rho` This is the correlation between the wiener processes of the Heston model\n",
    "*   `ou_a` This is the rate of mean reversion for Ornstein Uhlenbeck\n",
    "*   `ou_mu` This is the long run average interest rate for Ornstein Uhlenbeck\n",
    "*   `sheston_a` This is the rate of mean reversion for volatility in the Heston model\n",
    "*   `heston_mu` This is the long run average volatility for the Heston model\n",
    "*   `heston_vol0` This is the starting volatility value for the Heston model"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {},
   "outputs": [],
   "source": [
    "import random\n",
    "\n",
    "import tensortrade.stochastic as sp \n",
    "\n",
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Geometric Brownian Motion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x1440ee310>"
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "data = sp.gbm(\n",
    "    base_price=100,\n",
    "    base_volume=5,\n",
    "    start_date=\"2010-01-01\",\n",
    "    times_to_generate=1000,\n",
    "    time_frame='1H'\n",
    ")\n",
    "\n",
    "data.close.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Heston Stochastic Volatility Model"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x1452565d0>"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "data = sp.heston(\n",
    "    base_price=100,\n",
    "    base_volume=5,\n",
    "    start_date=\"2010-01-01\",\n",
    "    times_to_generate=1000,\n",
    "    time_frame='1H'\n",
    ")\n",
    "\n",
    "data.close.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Fractional Brownian Motion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x144656dd0>"
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "data = sp.fbm(\n",
    "    base_price=100,\n",
    "    base_volume=5,\n",
    "    start_date=\"2010-01-01\",\n",
    "    times_to_generate=1000,\n",
    "    time_frame='1H'\n",
    ")\n",
    "\n",
    "data.close.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Cox Ingersoll Ross (CIR)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x144253690>"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "data = sp.cox(\n",
    "    base_price=100,\n",
    "    base_volume=5,\n",
    "    start_date=\"2010-01-01\",\n",
    "    times_to_generate=1000,\n",
    "    time_frame='1H'\n",
    ")\n",
    "\n",
    "data.close.plot()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Ornstein Uhlebneck Process"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x1452b6c50>"
      ]
     },
     "execution_count": 36,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "data = sp.ornstein(\n",
    "    base_price=100,\n",
    "    base_volume=5,\n",
    "    start_date=\"2010-01-01\",\n",
    "    times_to_generate=1000,\n",
    "    time_frame='1H'\n",
    ")\n",
    "\n",
    "data.close.plot()"
   ]
  }
 ],
 "metadata": {
  "colab": {
   "collapsed_sections": [],
   "name": "Stochastic_Exchange.ipynb",
   "provenance": []
  },
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}
